home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / comm / w16rdb13.zip / W16RDB13.EXE / ABCPYDOC.INI < prev    next >
INI File  |  1996-09-26  |  15KB  |  318 lines
  1. ;*******************************************************************************
  2. ;
  3. ;ABCPYDOC.INI - This file is an example file that shows how to provide the
  4. ;               "blind-copy" capability for use with Adobe Acrobat installations.
  5. ;
  6. ;NOTE:  Do NOT use this file for blind-copy.  It is meant only as an example.
  7. ;*******************************************************************************
  8. ;
  9. ;Blind-copy capability provides a mechanism where an OEM or VAR may add to
  10. ;an installation set.  To trigger the blind-copy mechanism, a file named
  11. ;ABCPY.INI (Adobe Blind CoPY initialization file) must exist in the same 
  12. ;directory as the installer (SETUP.EXE) for Acrobat, whether for the individual
  13. ;Acrobat products or the Acrobat "umbrella". 
  14. ;
  15. ;ABCPY.INI is formatted similar to an .INI file, with section names that must
  16. ;match values set in ACROINST.INI (a hidden file used by Acrobat installations).
  17. ;For example, if an OEM needs the blind-copy capability for an Acrobat Reader
  18. ;installation, a section in ABCPY.INI must be named [ReaderBlindCopy].  If 
  19. ;Acrobat Exchange is the product installed, a section named [ExchangeBlindCopy] 
  20. ;must exist in ABCPY.INI.
  21. ;
  22. ;There are five types of "object actions" that can be added.  1) A "requirement"
  23. ;may be performed, 2) files can be copied, 2) program items or shortcuts 
  24. ;(depending on the target operating system) can be created, 3) registry entries 
  25. ;can be created, and 4) INI entries can be created.
  26. ;
  27. ;To have an action performed on these blind-copy objects, there are several 
  28. ;entries that must be made within the product's blind-copy section.  First,
  29. ;there must be a key named "NumberOfGroups" and this key must have a value
  30. ;of 1 or more.  
  31. ;
  32. ;For each "group", there will need to be entries for operating system platform, 
  33. ;target destination location, source location, and an optional entry for a 
  34. ;"group" name which is used for the group name when program items or shortcuts 
  35. ;are created.  
  36. ;
  37. ;By reviewing the example section in this file, the entries for each group are:
  38. ;Group<X>Platform=All
  39. ;Group<X>DestDir=Org
  40. ;Group<X>Loc=Org
  41. ;Group<X>Name=
  42. ;
  43. ;where <X> is replaced with the number of a specfic group.
  44. ;NOTE: The value for the group can be not larger than the number of groups as 
  45. ;        defined in NumberOfGroups key in this section.
  46. ;
  47. ;The platform key must contain a value contained in the following set: 
  48. ;(All, Win32, Win16, Win95, WinNT, !WinNT).  
  49. ;All means this group is targeted to all Windows operating system. 
  50. ;Win32 means the target platform is Windows 95 or Windows NT.
  51. ;Win16 means the target platform is only 16 bit Windows (3.1x). 
  52. ;Win95 means only Windows 95.  
  53. ;WinNT means only Windows NT
  54. ;!WinNT means the target platform is All except Windows NT.
  55. ;
  56. ;Group<X>DestDir contains the target detination directory name.
  57. ;
  58. ;Group<X>Loc is the source location relative to the main installation directory
  59. ;(i.e. on the source media of the installation set, NOT where the user chose to
  60. ;install Acrobat).
  61. ;
  62. ;All remaining keys are used for performing certain actions.
  63.  
  64. ;Each group can then have entries for the five "object actions" and those actions
  65. ;use the group settings for determining the source, destination, etc.  Below is
  66. ;a description of how to set these up correctly.
  67. ;
  68. ;>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  69. ;REQUIREMENTS
  70. ;
  71. ;To have a "requirement" performed, there must be one line in the group as follows:
  72. ;
  73. ;Group<X>NumberOfRequirements=<Y>, where <X> is the group number and <Y> is the 
  74. ;number of requirement actions to be performed for this group.  At this time, the
  75. ;only supported requirement is running the Windows application REGEDIT.EXE which
  76. ;can be used to add registry entries using a pre-defined registry file.
  77. ;
  78. ;The following shows an example requirement using REGEDIT:
  79. ;
  80. ;Group2NumberOfRequirements=1
  81. ;Group2Requirement1=REGEDIT
  82. ;Group2RegEditFile=Extra\Extra32.REG
  83. ;
  84. ;The key Group<X>RegEditFile=<.REG file> is used to tell the installer where
  85. ;the .REG file exists.  The .REG file must exist on the users system in a
  86. ;sub-directory of the path where Acrobat was installed.  This .REG file will
  87. ;then be run via REGEDIT.EXE.
  88. ;
  89. ;>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  90. ;FILE COPYING
  91. ;
  92. ;To have a file "blind copied" during installation, there must be a key named
  93. ;Group<X>NumberOfFiles, and the value of this key must be the number of files to 
  94. ;be copied from this source location to the group's target destination as defined 
  95. ;in the Group<X>DestDir and Group<X>Loc keys.
  96. ;
  97. ;For each file to be copied, a key of the following format must be defined:
  98. ;Group<X>FileName<Y>, where <X> is the group number and <Y> is the file number.
  99. ;NOTE: The file number cannot be greater than the number of files value.
  100. ;
  101. ;NOTE: There is no mechanism to rename files as they are copied.
  102. ;
  103. ;NOTE: Files will be directly copied.  The blind-copy mechanism would not know
  104. ;      which decompression scheme to use.
  105. ;
  106. ;<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  107. ;PROGRAM ITEMS AND SHORTCUTS
  108. ;
  109. ;To    create a program item or shortcut, a key must be defined containing the number
  110. ;of "icons" to be created.
  111. ;
  112. ;If the number is one or more, a key in the following format must be defined:
  113. ;Group<X>Icon<Y> (see notes above regrarding numbering).
  114. ;
  115. ;The value for these keys is rather cryptic, so please bear with this discussion.
  116. ;This type of object action requires a comma-delimited (i.e. separated by commas)
  117. ;value that has a variable number of parameters depending on the value of the first 
  118. ;parameter.
  119. ;
  120. ;The first parameter of the value must be either SYTLE1 or STYLE2.  
  121. ;STYLE1 is used when the object referred to is an executable or an automatically 
  122. ;launched file (i.e if the file's extension automatically launches the correct 
  123. ;executable).
  124. ;STYLE2 is used when the object referred to requires a primary executable to launch
  125. ;the second file (e.g. NOTEPAD.EXE is often used for launching a ReadMe file).
  126. ;
  127. ;Once the STYLE<X> is defined, the second portion refers to the working directory 
  128. ;for the file named in the third portion.  There are a limited number of values allowed
  129. ;for this second parameter.  If the first character is a '$' then the following values
  130. ;are accepted: Windows or WindowsSystem.  These refer to the directory where Windows is
  131. ;installed or the Windows System directory, respectively.
  132. ;
  133. ;As stated above, the third parameter is the name of the executable file (or automatically
  134. ;launched file is that is appropriate).
  135. ;
  136. ;The fourth parameter is the literal text that will be displayed in the Windows UI that
  137. ;describes the main file (for STYLE1 this is the file referred to in the 3rd parameter,
  138. ;for STYLE2 it is the file referred to in the 7th parameter).
  139. ;
  140. ;For the fifth parameter (and last for STYLE1 entries), this is a number for the index to
  141. ;the icon for Windows to use from the 3rd parameter.  This is typically 0 (zero).
  142. ;
  143. ;STYLE2 entries require two more parameters.  The sixth parameter is the location or
  144. ;working directory of the file referenced in the seventh and last parameter.
  145. ;
  146. ;The following explanation of the example entries should clarify most questions.
  147. ;
  148. ;Group1Icon1=STYLE1,Org,Match.exe,Match,0
  149. ;In this example, the above entry will create a program item or shortcut in the same 
  150. ;folder as was used by the Acrobat installation (because Group1Name is blank).  The item
  151. ;will display "Match" (the 4th parameter) as the description, and the command line created 
  152. ;will be for the program named Match.exe that is located in the Org directory below where 
  153. ;the user chose to put their Acrobat program files.  The first icon indexed within Match.exe 
  154. ;will be used in displaying the item.
  155. ;
  156. ;Group1Icon2=STYLE2,$Windows,Notepad.exe,Match ReadMe,0,Org,Readme.txt
  157. ;Here the entry will create a program item or shortcut in the same folder as was used by
  158. ;the Acrobat installation (because Group1Name is blank), for the file named Readme.txt
  159. ;that is located in the Org directory below where the user chose to put their Acrobat
  160. ;program files.  The description the user will see is "Match ReadMe" and the icon displayed
  161. ;will be the default icon for Notepad.exe.  The command line used to launch this item will
  162. ;be "<Windows drive and directory>\Notepad.exe <Drive and directory for Acrobat>\Org\Readme.txt"
  163. ;
  164. ;NOTE: Be careful when using Write.exe, because this file is located in    either the Windows
  165. ;        directory or the Windows System directory (on NT 4.0), thus making an entry that uses
  166. ;        Write.exe platform dependent.
  167. ;
  168. ;<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  169. ;REGISTRY ENTRIES
  170. ;
  171. ;To create registry entries within a group, the first required line is:
  172. ;Group<X>NumberOfRegEntries=<Y>, where <X> is the number of the group and <Y> is the
  173. ;                                number of registry entries to add.
  174. ;
  175. ;For each registry entry, there must be a key with a comma-delimited value containing six parts.
  176. ;
  177. ;The first parameter is the target platform.  The platform defined at the group level may be broader
  178. ;than the registry entry, so there is another means of differentiating settings based on the
  179. ;operating system of the end-user.  The same values for platform are used for both the group and
  180. ;the registry entries (and, as you will see, for INI settings).
  181. ;
  182. ;The second parameter in the comma-delimited value is the parent class where the registry entry
  183. ;will be created.  The most commonly used values here are HKEY_CLASSES_ROOT (the only valid
  184. ;parent for 16 bit Windows), HKEY_LOCAL_MACHINE, and HKEY_CURRENT_USER.  These are the only
  185. ;values currently valid within the blind-copy mechanism.
  186. ;
  187. ;The third parameter is the subkey within the registry where the entry will be created.
  188. ;
  189. ;The fourth parameter is used for the "named value" portion of the registry key.  For 32 bit
  190. ;Windows platforms, keys may have multiple named values under one key.  For the 16 bit registry,
  191. ;there is no named value capability, thus all registry entries within a key are set to a default
  192. ;named value (as exemplified below in Group1RegEntry2 where the 4th parameter is "Default").
  193. ;
  194. ;The fifth parameter is used for setting the type of data to be stored in this registry key (or in
  195. ;the named value of that key).  The currently supported settings are STRING, MULTIPLE_STRING,
  196. ;EXPANDABLE_STRING, and NUMBER.  MULTIPLE_STRING is used when the string data has new lines embedded.
  197. ;EXPANDABLE_STRING is used when the string data contains an expandable environment variable such as
  198. ;"%PATH%".
  199. ;
  200. ;The sixth parameter is the literal value for the key or named value.
  201. ;
  202. ;Below are two examples of similar entries, one for the 32 bit registry and one for 16 bit registry.
  203. ;
  204. ;Group1RegEntry1=Win32,HKEY_LOCAL_MACHINE,Software\Adobe\Acrobat,BlindCopy,STRING,Match Utility
  205. ;Group1RegEntry2=Win16,HKEY_CLASSES_ROOT,Software\Adobe\Acrobat\BlindCopy,Default,STRING,Match Utility
  206. ;
  207. ;
  208. ;<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  209. ;INI SETTINGS
  210. ;
  211. ;To create INI settings within a group, the first required line is:
  212. ;Group<X>NumberOfIniSettings=<Y>, where <X> is the number of the group and <Y> is the
  213. ;                                number of INI settings to add.
  214. ;
  215. ;For each INI setting, there must be a key with a comma-delimited value containing six parts.
  216. ;
  217. ;The first parameter is the target platform.  The platform defined at the group level may be broader
  218. ;than the INI setting, so there is another means of differentiating settings based on the
  219. ;operating system of the end-user.  The same values for platform are used for both the group and
  220. ;the INI settings.
  221. ;
  222. ;The second parameter in the comma-delimited value is the directory location of the INI file.  Again,
  223. ;$Windows and $WindowsSystem are valid settings as well as literal directories that are relative to
  224. ;where the Acrobat files were decompressed during installation.
  225. ;
  226. ;The third parameter is the INI file name.  If the file does not exist, it will be created.
  227. ;
  228. ;The fourth parameter is the section in the INI file where the setting will be made.  The section
  229. ;be created if it does not exist.
  230. ;
  231. ;The fifth parameter is the INI key within the section.
  232. ;
  233. ;The sixth parameter is the value for the key in the section.
  234. ;
  235. ;The following is a simple example that will create an entry in <Windows>\ArcoExch.ini under the
  236. ;section [BlindCopy] the following key:
  237. ;Match=Match.exe
  238. ;
  239. ;Group1IniSetting1=Win16,$Windows,AcroExch.ini,BlindCopy,Match,Match.exe
  240. ;
  241. ;>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  242. ;
  243. ;At this time, this is the current functionality of the blind-copy mechanism that can be used
  244. ;with Adobe Acrobat installations.
  245. ;
  246. ;The following entries can be used as examples for the correct syntax for performing the various
  247. ;blind-copy actions.  These examples should not be used literally, unless by some miracle, your
  248. ;installation has these exact same files and settings.
  249. ;
  250. ;>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  251.  
  252. [ReaderBlindCopy]
  253. NumberOfGroups=5
  254.  
  255. Group1Platform=All
  256. Group1DestDir=Org
  257. Group1Loc=Org
  258. Group1Name=
  259. Group1NumberOfFiles=3
  260. Group1FileName1=Match.exe
  261. Group1FileName2=Match.hlp
  262. Group1FileName3=ReadMe.txt
  263. Group1NumberOfIcons=2
  264. Group1Icon1=STYLE1,Org,Match.exe,Match,0
  265. Group1Icon2=STYLE2,$Windows,Notepad.exe,Match ReadMe,0,Org,Readme.txt
  266. Group1NumberOfRegEntries=2
  267. Group1RegEntry1=Win32,HKEY_LOCAL_MACHINE,Software\Adobe\Acrobat,BlindCopy,STRING,Match Utility
  268. Group1RegEntry2=Win16,HKEY_CLASSES_ROOT,Software\Adobe\Acrobat\BlindCopy,Default,STRING,Match Utility
  269. Group1NumberOfIniSettings=1
  270. Group1IniSetting1=Win16,$Windows,AcroExch.ini,BlindCopy,Match,Match.exe
  271.  
  272. Group2Platform=Win32
  273. Group2DestDir=
  274. Group2Loc=Extra
  275. Group2Name=
  276. Group2NumberOfRequirements=0
  277. Group2NumberOfFiles=1
  278. Group2FileName1=Extra32.REG
  279. Group2NumberOfIcons=0
  280. Group2NumberOfRegEntries=0
  281. Group2NumberOfIniSettings=0
  282.  
  283. Group3Platform=Win32
  284. Group3DestDir=
  285. Group3Loc=
  286. Group3Name=
  287. Group3NumberOfRequirements=1
  288. Group3Requirement1=REGEDIT
  289. Group3RegEditFile=Extra\Extra32.REG
  290. Group3NumberOfFiles=0
  291. Group3NumberOfIcons=0
  292. Group3NumberOfRegEntries=0
  293. Group3NumberOfIniSettings=0
  294.  
  295. Group4Platform=Win16
  296. Group4DestDir=
  297. Group4Loc=Extra
  298. Group4Name=
  299. Group4NumberOfRequirements=0
  300. Group4NumberOfFiles=1
  301. Group4FileName1=Extra16.REG
  302. Group4NumberOfIcons=0
  303. Group4NumberOfRegEntries=0
  304. Group4NumberOfIniSettings=0
  305.  
  306. Group5Platform=Win16
  307. Group5DestDir=
  308. Group5Loc=
  309. Group5Name=
  310. Group5NumberOfRequirements=1
  311. Group5Requirement1=REGEDIT
  312. Group5RegEditFile=Extra\Extra16.REG
  313. Group5NumberOfFiles=0
  314. Group5NumberOfIcons=0
  315. Group5NumberOfRegEntries=0
  316. Group5NumberOfIniSettings=0
  317.  
  318.